[Manager Summary]
Initializes an imaging environment for printing a document.
OSStatus PMBeginDocument(PMPrintSettings printSettings, PMPageFormat pageFormat, PMPrintContext *printContext)
PARAMETERS
printSettings
- The PMPrintSettings object that your application has created for the current print job.
pageFormat
- The PMPageFormat object that your application has created for the current print job.
printContext
- On return, an initialized PMPrintContext object that describes a printing port; that is, a graphics environment for imaging the current print job. Your application prints text and graphics by drawing into this printing port.
- function result
- A result code. See Result Codes.
DISCUSSION
The PMBeginDocument function initializes a printing port. To print a document, your application draws into this printing port.
You must balance a call to PMBeginDocument with a call to the function PMEndDocument.
CARBON PORTING NOTES
The PMBeginDocument function replaces the Printing Manager function PrOpenDoc.
The Printing Manager function PrOpenDoc included a parameter that pointed to an input and output buffer. For Carbon, drivers are assumed to be handling I/O buffering. Therefore, PMBeginDocument has no similar parameter.
Last modified: 5/7/99. Status: Draft Copyright 1999 Apple Computer, Inc. All rights reserved.